home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / bbs / msrch10.zip / MULTSRCH.DOC < prev    next >
Text File  |  1996-07-01  |  21KB  |  417 lines
  1.  
  2.                     Documentation for MultiSearch Text Door
  3.                          Written by Robert V. Chambers
  4.                                Copyright (c) 1996
  5.  
  6.  
  7. WHAT IS MULTISEARCH TEXT DOOR?
  8. MultiSearch Text Door is a BBS door program that will let you, the sysop, make
  9. text  files  available  to  your users  for  on-line  viewing,  searching, and
  10. downloading.  Sounds  dull, right? Well, there's  a  catch. This door makes it
  11. possible  to not only view a file but to also search for text within the file.
  12. And not just within one file, either. With MultiSearch Text Door you can elect
  13. to  search across any files that are  available and display the results a page
  14. at  a  time,  or only display the  lines  that  meet the search criteria. Just
  15. select  the  files of interest, enter text to  search for, and let it go. It's
  16. the   perfect   utility  door  for  scanning   your  log  files,  making  game
  17. documentation  or  faq sheets available, etc.  MultiSearch  Text Door makes it
  18. extremely  easy  to access the information you  and  your users want and need.
  19. With DSZ your user can download any file that he/she has clearance to view.
  20.  
  21. The  door  provides  ANSI graphics file capability  so  that you can make your
  22. favorite  ANSIs  available to your users,  thus extending the functionality of
  23. the  door.  Though  the primary function  is  text reading and searching, this
  24. feature was added at the encouragement of the beta testers.
  25.  
  26. While  most  doors  are aimed at either the  user  or the sysop, this one will
  27. benefit both.
  28.  
  29. SYSTEM REQUIREMENTS:
  30. 386 or better processor
  31. 220K memory (probably less, just being conservative).
  32.  
  33. WHAT ARE SOME OF THE FEATURES?
  34. *  Search multiple files for information.
  35. *  Display ANSI graphics files.
  36. *  Up to 225 files can be made available. (Registered only)
  37. *  Download files of interest. (Requires DSZ)
  38. *  Up to 20 document categories.
  39. *  Optional activity log.
  40. *  On-line help.
  41. *  Simple Boolean search patterns.
  42. *  Page numbering.
  43. *  Displays file size and date.
  44. *  File-specific security clearance.
  45. *  Custom color configuration of file and category menus.
  46. *  Comes complete with menu editor for adding or removing documents.
  47. *  Has a sysop chat mode.
  48. *  Fossil aware.
  49. *  Supports   standard   drop  files   such   as  DOOR.SYS  (PCBoard/GAP),
  50.    DORINFO1.DEF, EXITINFO.BBS, CHAIN.TXT, etc.
  51. *  Supports multiple nodes.
  52. *  Includes an editor to make menu maintenance a snap.
  53. *  These are the basics, but there's lots more!
  54.  
  55. LIMITATIONS ON UNREGISTERED VERSION:
  56. The  unregistered version will only support 10 documents in the menu. You must
  57. register  the  program  to  eliminate this  restriction.  See  the  section on
  58. registration below.
  59.  
  60. WHERE ARE THE INSTRUCTIONS ON USAGE?
  61. All  instructions on how to use the door once it has been installed are in the
  62. on-line  help file. If you can't wait, and  want to read it now, the help file
  63. is  called "multsrch.hlp". Be careful that  you don't inadvertently change the
  64. wording  in  the file, since this is the  one  that will be displayed when the
  65. user  enters on-line help! Of course, you are free to edit it if you wish, and
  66. may even like to add some additional information.
  67.  
  68. HOW DO I INSTALL IT:
  69. This is simple, but you must follow these instructions. I am assuming that you
  70. are already familiar with the steps required to install a door on your BBS. If
  71. not,  I  would  suggest  that you read  your  manual  first. This doc will not
  72. attempt to guide you through that.
  73.  
  74. Step  1) Unzip all files into a single directory of your choice.
  75.  
  76. Step  2)  Create a batch file that your BBS  will use to start the door. I use
  77.         PCBoard, and my file looks something like this:
  78.  
  79.         @echo off
  80.         cd\pcb\search
  81.         multsrch.exe c:\pcb\node1\door.sys /L
  82.         IF "%INPCB"=="Y" EXIT
  83.         %PCBDRIVE%
  84.         %PCBDIR%
  85.         board
  86.  
  87.         You  may call the file whatever you like, subject to restrictions that
  88.         may  be  enforced by your BBS  software. Mine is simply called SEARCH,
  89.         with no .BAT extension. Again, consult your manual.
  90.  
  91.         A  little explanation of the startup batch  file is in order here. The
  92.         first  line  simply  changes  to  the  directory  where  all  of  your
  93.         MultiSearch  Text Door program files are found. (Remember you put them
  94.         there  in  Step 1.) The second line  is  the name of the door program,
  95.         MULTSRCH.EXE,  followed by the complete path to your drop file and the
  96.         (optional)  log  file  switch.  Notice  that  the  drop  file  name is
  97.         specified.  If  you  are using PCBoard,  you  may also use the PCBoard
  98.         environment variables for the path to the drop file. Like this:
  99.  
  100.                         multsrch.exe %PCBDRIVE%%PCBDIR%\door.sys
  101.  
  102.         If you wish the program to log its activities, add "/L" after the path
  103.         to  the  drop  file like this:
  104.  
  105.                         multsrch.exe %PCBDRIVE%%PCBDIR%\door.sys /L
  106.  
  107.         The program will create MULTSRCH.LOG which will contain information on
  108.         door usage.  See the section below on "LOGGING ACTIVITY".
  109.  
  110.         Finally,   use   whatever  door   exiting   statements  your  software
  111.         recommends. Your startup file will undoubtedly look different, but you
  112.         get the general idea.
  113.  
  114.  
  115. Step  3)
  116.         Set  up  the category menu. If you  want to set up categories for your
  117.         documents  (and you should!) you must  first create MAIN.CFG using any
  118.         ASCII  text editor. Refer to  SAMPLE1.CFG for complete instructions on
  119.         the  contents of this file. This file is very simple and contains only
  120.         the  number of categories you wish to use and the description of each.
  121.  
  122.         If you do not want to use categories, but would rather have all of the
  123.         files  listed  in a single menu, you  can  skip this step. The program
  124.         will  provide your users with an option to list all files, so there is
  125.         really  no  reason not to set up  categories.  Also, you will not have
  126.         access  to  the door statistics or  file  properties display since the
  127.         menu option for these functions is available only through the category
  128.         menu.
  129.  
  130.         Note that the category configuration file MUST be called MAIN.CFG, and
  131.         MUST  reside in the program file  directory. The first category listed
  132.         will  be  category  1, the second category  2,  and  so forth. You may
  133.         define  a  maximum  of  20  categories  in  either  the  registered or
  134.         unregistered version.
  135.  
  136. Step  4)
  137.         Next  run  MULTEDIT.EXE to build the  document list menu. This program
  138.         will build the menu configuration file, MULTSRCH.CFG and add a default
  139.         entry.  Edit  this  entry with the  proper  information for your first
  140.         document. MULTEDIT.EXE is a very simple program that will let you add,
  141.         modify,   and  delete  document   entries,  change  your  registration
  142.         information,  etc.  You should use this  program each time you wish to
  143.         make modifications to your document menu. See MULTEDIT.DOC information
  144.         on this program.
  145.  
  146.         Alternatively  you  can  use  any  text  editor  to edit MULTSRCH.CFG.
  147.         Complete instructions for editing are included in SAMPLE2.CFG. Be sure
  148.         to  follow  these  carefully. Note that  no  lines  can be skipped and
  149.         comments  are not allowed. An explanation of  each line in the file is
  150.         included in SAMPLE2.CFG.  I don't recommend this because it's too easy
  151.         to make a mistake.
  152.  
  153.         If you have ANSI graphics files you would like to make available, they
  154.         must  contain  ".ANS"  in the  filename  (usually the file extension).
  155.         Non-graphics users will not be able to display these files.
  156.  
  157.         NOTE:  Using  categories is optional.  However, the program presents a
  158.         much   more  organized  environment  for  the  user  with  categorized
  159.         documents.  Without  the  category menu the  user  will see all of the
  160.         files  listed  together  in a single menu